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December 17, 1986 
Errata for Site Administration Notes 

1. p. 2, under "Mouse Documentation lines". Change "thirds" to "third" 

2. p. 47, in the righthand column. "Add" should be removed 

3. p. 51, in the smalLboot example. The second line should read: 
Declare Paging fep0:>page 

4. p. 51, third to last line, "it's" should be capitalized. 

5. p. 60, step 6 isn't really a separate step. 

6. p. 64, line 2. Change "buy" to "by". 

7. p. 77, third paragraph from the bottom, "eg." should be "e.g." 

8. p. 78, in the example at the bottom. The lines which begin: 
100 200 300 400 

should end: 

35100 35200 35337 

9. p. 79, step 3. Typing FUNCTION n-C will not have any effect on the saved 
world, as Genera 7.0 resets the mouse documentation line before saving the 
world. Instead, go to FSEdit and edit the root directory on the file server. 

10. p. 82, top line in section 9.2. Insert "has" after "Each object." 

11. p. 86, last paragraph. "5 thru 8" should be "5 thru 7." 

12. p. 87, second to last paragraph Again, "eg." should be "e.g." 

13. p. 102, two-thirds of the way down the page. Change "Insert the following 
lines" to "Insert the following line" 
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1.1 Lisp Machine Anatomy 

The Symbolics 3600-series computer is a single user computer, just like your 
favorite microcomputer. We use the term "3600-series" because there are several 
different models that Symbolics sells (and has sold) that are very similar. 

Symbolics 3600-series computers have two major physical parts, the console and 
the processor box. 

In the processor box you will find: 

• Front End Processor (FEP) board 

• Lisp Processor board(s) 

• Memory board(s) 

• Disk drive(s) 

• Paddle Card(s) 

• Cooling Fans, etc. 

On the outside of the processor box are RESET and POWER switches. On most 
machines these are two buttons. On the 3650 they are part of a key operated 
switch. On the 3600 they are toggle switches. You will also find (on most 
models) serial and parallel ports and a network connection. At least one machine 
at each site will have a tape drive. There is nothing user-serviceable inside the 
processor box 

The console has three parts: the screen, the keyboard and the mouse. 

When the Lisp software is running, the screen has three particularly interesting 

areas. " to 

Status line The very bottom line contains some generally useful 

information. 

Mouse Documentation lines 

The second and thirds lines from the bottom (typically in 
reverse video) tell you what each of the three mouse buttons 
would do if you pressed it now. 

Main Screen Everything above the status and mouse documentation lines is 

available for use by any program or system utility. 

The keyboard is an extended keyboard. It has all of the normal computer 
keyboard keys as well as some that are unique to Symbolics. 

The mouse has three buttons. These are called "Left", "Middle" and "Right". 
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Diagram Of A Typical Network 
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1.2 Controlling The Processor 

1.2.1 Stopping the processor 

You can do either of the following to stop execution of the Lisp processor. Each 
has a time and place where it is most useful: 

• Command: Halt Machine 

• Press the keys: Hyper Control Function together 

After either of the above actions you will see the following prompt at the top of 
your screen: " ^ 



Lisp stopped itself 
FEP Command: 

On very rare occasions you might have to stop the processor using the RESET 
switch on the processor box. 

1 .2.2 Booting the processor 

The subject of booting will be covered in detail later in the course, but for now 
when you are ready to restart Lisp you can enter the following command: 

Fep Command: Boot 



1.2.3 Controlling the console 

LOCAL B Screen gets brighter 

LOCAL D Screen gets dimmer 

LOCAL L Makes the audio louder 

LOCAL Q Makes the audio quieter 

LOCAL n C Changes the contrast of the screen, "n" is a number from one 

to four. Four is the highest contrast. 



Note: On the beige keyboard even though the LOCAL key has white lettering, you 
must press it simultaneously with the key it modifies. 
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1.3 Getting Out Of "Stuck States" 

Things that can get you into stuck states 

• Killing windows 

• Overlapping windows 

• Aborting out of menus 

Things that can get you out of stuck states 

• Function Escape causes the window that wants to display something new to 
be exposed. This command is useful for the conditions Output Hold and 
Sheet Lock. 

• Function 0-S brings up any window that wants to display an error. 

• Function c-T clears temporary window system locks. This command is useful 
for Sheet Lock. 

• Function c-Clear Input clears all window system locks. This command is 
useful for Sheet Lock. 

• Function - A (Function minus A) Unarrests a window which has become 
arrested. This is useful for the Arrested condition. 

• The condition (no window) occurs when the window system is confused as to 
which is your current window. Selecting another window should clear this 
up. 

• If you find your self in the cold load stream the window system is in trouble. 
Read the information displayed by the debugger carefully and take 
appropriate action. Usually, ABORT is the right thing to do. 

• If you were thrown into the cold load stream because the window system is 
locked up usually "unlock all window system locks?" is one of your options. 
You should respond "Yes". 
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2. Lisp Machine File System 



The Root 

Directories 

Files 

Fsedit 
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2.1 The File System 

The Lisp Machine file system is a tree (hierachy) of files and directories. The 
directory that is at the root of the tree is called the root directory. The following 
are some of the features of the Symbolics file system: 

• A file has a name, an extension (or type), and a version 

• The name can be a string of any length 

• The extension can be a string of up to fourteen characters 

• The version is a positive integer from one to 16,777,215 

• The name and extension strings are case insensitive 

• You cannot have the characters n o.:" or "Return" in the name or extension 

• Soft deletion is supported (Delete / Undelete / Expunge) 

• Files and directories maintain information about their author, creation date, 
etc. called properties 



Listed below are some of the file extensions and files that are important to most 
people who use the Lisp machine: 

File extensions 

text Character files that contains text of some sort 

lis P Character files that contain Lisp source code 

bin Binary files that contain compiled programs 
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2.2 Pathnames 

A Symbolics computer generally has access to many file systems. All the files ^ 
these file systems can be accessed by their pathname. Pathnames are composed of 
the following parts: 

2.2.1 Pathname components 

• Host 

• Directory 

• File 

2.2.2 Pathname examples 

;;; Lisp machine pathnames 

host:>directory>file 

cd : >sys>si te>sys . transl ati ons 

anni : >dog-house>bed>bone-to-pi ck . 1 i sp . 22 

; ; ; Unix pathnames 

host:/directory/file 

vixen : /ufs/f red/notes . txt 

; ; ; VMS pathnames 

host: :dsk:[directoryj 'file 

drkstr: :aiko: [roy] concerts. txt 

There are other forms of pathnames that we will discuss in the chapters on 
Backups, the FEP file structure and Installing Software 
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2.3 The File System Editor (FSEdit) 

FSEdit is a menu-oriented program for dealing with the file system. It can be 
used by anyone to access their own files and directories, and by the system 
administrator to perform backups and do other more basic operations to the file 
system. To use FSEdit enter SELECT F. 

FSEdit has a four level menu structure. The operations available become more 
dangerous and less useful for the average user as you proceed to higher level 
menus. Level 1 is useful to all users. Level 2 contains basic operations for the 
System Administrator. Level 3 contains more powerful/dangerous operations for 
the System Administrator. Level 4 contains operations useful only to wizards who 
understand the internals of the File System. 

In this chapter we will concentrate on level one. The three most important menu 
items at this level are: 

• Tree Edit Root 

• Tree Edit Any 

• Tree Edit Home Dir 
FSEdit Level One Menu 

When you edit a directory the inferior directories are listed first followed by the 
files contained in that directory. Every directory and file is mouse sensitive. The 
meanings of the mouse clicks are as follows: 

Left Open the directory (Display its contents) 

Middle Close the directory containing this file. 

Right Menu of operations 



The rest of this chapter will be screen snapshots demonstrating the following uses 
of FSEdit. 

• Tree Edit Any 

• Opening/Closing directories 

• Deleting and Undeleting files 

• Expunging directories 

• Automatic expunging of old deleted files 

• Controlling the number of versions of a file 
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>er1e-uo1f >nenos 

>er 1 c-uo 1 f>n 1 cro-courses 

>er1c-uolf>person«1 

>er-1c-uolf>pr-ojects 

>er1c-uolf >sales-course 

>er1c-uolf>s1te-course 

>eHc-wolf>ta-Job 

>er1c-uolf>w&f-course 

>er1c-uolf>uorkbooks 

babyl.text.2512 52 235112(B) t 

baby1.teKt.29l3 53 238343(8) I 

Hspn-1n1t.bin. 25 1 1152(16) 

Hspn-1nlt.Hsp.59 1 3221(8) 

Hspn-1n1t.Hsp.6B 1 3153(8) 



Iree Ldit Any 
Help 



Iree Ldit home dir 
Local LMFS Operations 



Lisp Window 



9 



Oo 



thing 



inall 
mall 



is-to-do.text.3 1 460( 8) 

-1n1t.bin. 22 "^ 1 1460(16) 



11/21/86 11:53:12 (11/21/86) 
11/21/86 12:09:11 (11/21/86) 
11/14/86 18:35:17 (11/21/86) 
89/25/86 18:40:11 (11/14/86) 
11/14/86 18:34:48 (11/17/86) 



» 8B/14/86 16:55:18 ( BR/14/aAr 
09/25/86 15:47:59 (11/21/861 



•1n1t.Hsp.63 1 3285(8) 09/25/86 15:*47l55 (10/88/86) 
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00 



File 



system tditlne oBtratltms 
Iree tdit Root 



Refresh Display 



: >eri c-uol f >*.*.* 

> er 1 c-uo 1 f > c 1 1 -course 
>eric-uolf>cl2-course 
>eri c-uol f >course-eva 1 uat 1 on 
>er 1 c-uo 1 f > ngner«-7-8-cour«p 



Iree tdit f\ny 
Help 



1184(^6) 
1187(16) 



".:>ei-1c-uolf >hacks>».» .» 

D check-nail. bin. 4 1 

check-nail. bin. 5 1 
D check-nail. lisp. 4 1 

check-nail. lisp. 5 1 
connands.lisp.3 1 

copy-tree. lisp. 1 1 

delete-tree.llsp.l 1 

nelt.lisp.l 2 

nelt.Hsp.2 2 

overnight. bin. 2 
ouernight.Hsp.2 
>er1c-uolf>nai! 
>eric-wolf>nenos 
>er1 c-uol f>n1cro-courses 
>eric-uolf>personal 
>er1c-uolf>projects 
>eri c-uol Dsales-course 
>eric-uoir>site-course 
>er1e-uolf>ta-job 
>er1c-wolf>u&f-course 
>eric-uolf> workbooks 
baby 1. text. 291 2 52 235112(8) 
babyl. text. 2913 53 238343(8) 



3195(8) 
1 3212(8) 
411(8) 
892(8) 
1 892(8) 
4678(8) 
3827(8) 
569(16) 
853(8) 



lispn-1nit.bin. 23 

lispn-init.11sp.59 

11spn-init.11sp.6e 

th 1 ngs-to-do . text . 3 

rnail-init.b1n.22 

zna1l-1n1t.11sp.63 



I 



1152(16) 
3221(8) 
3153(8) 
468(8) 

1468(16) 
3285(8) 



Iree Edit home dir 
Local LMFS Operations 



Lisp Window 



§ 



o 



08/88/86 13: 
89/23/86 16: 
08/88/86 13: 
09/23/86 16: 
85/21/85 IS: 
85/16/85 11: 
05/16/85 11 
09/09/86 14: 
89/17/86 18 
07/88/85 13: 
87/88/85 13: 



47:55 (09/18/86) 
17:26 (11/21/86) 
42:89 (89/23/86) 
17:81 (11/17/86) 
52:44 (88/83/86) 
85:87 (08/83/86) 
:84:58 (88/83/86) 
53:37 (89/89/86) 
59:12 (89/19/86) 
25:19 (08/03/86) 
21:53 (88/83/86) 



11/21/86 11:53:12 (11/21/86) 
11/21/86 12:89:11 (11/21/86) 
11/14/86 18:35:17 (11/21/86) 
89/25/86 18:48:11 (11/14/86) 
11/14/86 18:34:48 (11/17/86) 
I 08/14/86 16:55:18 (88/14/86) 
89/25/86 15:47:59 (11/21/86) 
89/25/86 15:47:55 (18/88/86) 



eric-uolf 

eri c-uol f 

eric-uolf 

eric-uolf 

JLB 

BIGBOB 

BIGBOB 

eric-uolf 

eric-uolf 

eric-uolf 

eric-uolf 



I 



00 



File system edit me operations 
Tree Ldit Root 



Refresh Display 



j U: > eric-wolf >* . * . 
>er1c-uolf: 
>er1c-uolf: 
>er1c-uo1f 
>er1c-uolf : 
U:>ertc-uo 
check -nal 
check-na1 
check-no 1 ' 
check-nai' 
connands. ' 
copy-tree, 
delete-tre 
nelt. lisp. 
nelt.Hsp. 
overnight.. ...._ 

overnight. lisp. 2 
>er1c-wolf>ne1l 



Tree Edit Any 
Help 



Director s operatio n -;; 



Delete 

Close 

Decache 

tminael 

Create Inferior Directory 

View Properties 

Edit Properties 

New Property 

Create link 

Rename 

Wildcard Delete 

Link Transparencies 



free tdit home dir 
Local LMFS Operations 



Lisp Window 



l 



853(8) 



(7:55 (£ 
17:26 (1 
12:09 (( 
17:81 (1 
52:44 (6 
35:87 (( 
:B4:S8 . 
53:37 (i 
59:12 (i 
25:19 (( 



89/18/86) 
11/21/86) 
89/23/86) 
11/17/86) 
88/83/86) 
88/83/86) 
(88/83/86) 
89/89/86) 
89/19/86) 
-. .88/83/86) 
87/88/85 13:21:53 (88/83/86) 



>er1c-uolf>nenos 

>er1c-uolf >n1cro-courses 

>er1c-uo1f>personal 

>er1c-uolf > projects 

>er1c-uolf>sales-course 

>er1c-uolf> site-course 

>er1c-uo1f>ta-job 

>er1c-uolf>u&f -course 

>er1c-uolf>uorkbooks 

babyl. text. 2912 52 235112(8) 

baby 1 . text . 291 3 53 238343 ( 8 ) 



I1spn-1n1t.bin. 25 
Hspn-1n1t.l1sp.59 
I1spn-1n1t.l1sp.68 
things-to-do. text. 3 
ina11-1nit.bin. 22 
ina1l-1n1t.Hsp.63 



I 
I 
1152(16) 
3221(8) 
3153(8) 
468(8) 
1468(16) 
32(15(8) 



11/21/86 11:53:12 (1 
11/21/86 12:89:11 (1 
11/14/86 18:35:17 ( 
89/25/86 18:48:11 ( 
11/14/86 18:34:48 ( 
t 88/14/86 16:55:18 
89/25/86 15:47:59 ( 
89/25/86 15:47:55 ( 



1/21/86) 

1/21/86) 

11/21/86) 

11/14/86) 

11/17/86) 

(88/14/86) 

11/21/86) 

18/88/86) 



erlc-uolf 

erlc-uolf 

erlc-uolf 

eric-wolf 

JLB 

BIGBOB 

BIGBOB 

erlc-uolf 

erlc-uolf 

erlc-uolf 

erlc-uolf 
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File system editing operations 
'tree Ldit Root 



Refresh Display 



Tree Edit Any 



Help 



)U: >eric-uolf >* .* .t 

>er1c-uolf>cll -course 
>eric-uolf>cl2-course 
>eric-uo1f>course-evaluation 
>er ic-uol f>genera-7-G-course 
M:>er1c-uo1f >hacks>».».« 
check-naH. bin. 5 1 1187(16) 
check-nail. lisp. 5 1 3212(8) 
connands . H sp . 3 1 411(8) 
copy-tree. I isp.l 1 892(8) 
delete-tree.lisp.l 1 892(8) 
nelt.lisp.l 2 4670(8) 
nelt.lisp.2 2 3827(8) 
overnight. bin. 2 1 569(16) 
ouerni9ht.!1sp.2 1 853(8) 
>er1c-wolf>na1l 
>er ic-uol f >nenos 
>eric-uolf>nicro-courses 
> eric-wolf > personal 
>er1c-uolf >proJects 
>er 1 c-upl f >sal es-course 
>er1c-wo1f>s1te-course 
>eric-uolf>ta-Job 
>er1c-uolf>uif-course 
>er ic-uol f>uorkbooks 
babyl.teKt.2912 52 235112(8) 
baby 1. text. 291 3 53 238343(8) 



Tree Edit home dir 
Local LMFS Operations 



Lisp U/indo 






11spn-1nit.bin. 25 
I1spn-1n1t.1isp.59 
Hspn-1n1t.l1sp.68 
th 1 ngs-to-do . text . 3 
ma1l-1n1t.bin. 22 
znail-1nit.11sp.63 



I 
I 

1152(16) 

3221(8) 

3153(8) 

468(8) 

1468(16) 

3285(8) 



09/23/86 16 
09/23/86 16 
85/21/85 15: 
05/16/85 11: 
05/16/85 11 
09/89/86 14: 
09/17/86 18: 
87/08/85 13: 
07/88/85 13: 



17:26 (11/2 
17:01 (11/1 
52:44 (88/6 
05:07 (88/£ 
:04:58 (88/ 
53:37 (B9/C 
59:12 (89/1 
25:19 (88/C 
21:53 (88/C 



Directory operati ons: >er ic-uol f>hark f 



Delete 

Close 

Decache 

Expunge 

Create Inferior Oirectoryl 

View Properties 

Edit Properties 

New Property 

Create link 

Rename 

Wildcard Delete 

Link Transparencies 



11/21/86 11:S3:12 (11/21/86) 
11/21/86 12:99:11 (11/21/86) 
11/14/86 18:35:17 (11/21/86) 
09/25/86 10:48:11 (11/14/86) 
11/14/86 18:34:48 (11/17/86) 
a 08/14/86 16:55:18 (08/14/86) 
09/25/86 15:47:59 (11/21/86) 
89/25/86 15:47:55 (10/88/86) 
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File system editing operations 
Iree Edit Root 



Refresh Display 



Iree Edit Any 
Help 



|U:>eMc-wolf >t .».« 

>er1c-uolf >cll -course 

>eMc-uolf >cl2-course 

>er i c-uol f >course-eva 1 ua 1 1 on 

>er1c-uolf>genera-7-8-course 

W:>er1c-uolf>hacks>».*.« 



Iree Edit home dir 
Local LMF5 Operations 



Lisp U/indc 



<t> 

I 
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s 



check-nail .bin. 5 
check-nail . Hsp.S 
connands . 1 1 sp . 3 
copy-tree. Hsp.l 
delete-tree.llsp.l 



nelt.lisp.l 2 

nelt.llsp.2 2 

overnight. bin. 2 1 569(16) 

overnight. lisp. 2 1 853(8) 
>er1c-uo1f >na11 
>er1 c-uol f>nenos 
>er1 c-uol f>n1cro-courses 
>er1c-wolf>per3onal 
>er 1 c-uol f >proJects 
>er 1 c-uol f >sal es-course 
>er1c-uolf >s1te-course 
>eric-uolf>ta-Job 
>er1 c-uol f >w&f -course 
> erl c -uo 1 f > uorkbooks 
babyl. text. 2912 52 235112(8) 
baby 1. text. 291 3 53 238343(B) 



11spn-1n1t.bin. 25 
Hapn-1n1t.l1sp.59 
Hspn-1n1t.l1sp.6B 
th1 ngs-to-do . text . 3 
zna1l-1n1t.bin. 22 
ina11-1n1t.11sp.63 



I 
I 

1152(16) 

3221(B) 

3153(8) 

468(B) 

1468(16) 

3285(8) 



1187(16) 
1 3212(8) 
411(8) 
892(8) 
1 892(8) 
4670(8) 
3827(8) 



09/23/86 it.n. f 11 ' " ar, > e for directory, 
89/23/86 16:17: Jspeclal -hacks! 
85/21/85 15:52: 



05/16/85 11:05:07 (0B/03/86) BIGBOB 

05/16/85 11:04:58 (88/83/86) BIGBOB 

09/09/86 14:53:37 (09/09/86) ertc-uolf 
09/17/86 10:59:12 (09/19/86) - f 

87/08/85 13:25:19 (08/03/86) erlc-uo f 

07/08/85 13:21:53 (88/03/86) erlc-uolf 



under >er1c-uolf >hacks: 



3 



11/21/86 11:53:12 (11/21/86) 
11/21/86 12:09:11 (11/21/86) 
11/14/86 1B:35:17 (11/21/86) 
09/25/86 10:40:11 (11/14/86) 
11/14/86 18:34:48 (11/17/86) 
• 08/14/86 16:55:18 (08/14/86) 
09/25/86 15:47:59 (11/21/86) 
89/25/86 15:47:55 (10/08/86) 
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File system editing o ptrat/xm* 



.... sins operatic* 
tree Edit Root 
Refresh Display 



U:>er1c-uolf>*.*.» 

> er 1 c-uo 1 f ) c 11 -course 

> er i c-uo 1 f > c 1 2-course 
>er i c-uo) f >course-eva1 uat 1 on 
>er1c-uolf>oenera-7-0-course 
H:>er1c-uolf>hacks>«.».* 

>er1c-uolf>hacks>spedal-hacks 



Iree Edit f\r\y 
Help 



Iree Edit home dir 
Local LMFS Operations 



Lisp Window 



to 
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check-naH .bin. 5 
check-nail . Hsp.5 
connands . 1 i ap . 3 
copy-tree. liap.l 
delete-tree.Hap.l 



1 1187(16) 
1 3212(8) 
1 111(8) 

1 892(8) 

1 892(8) 

1678(8) 
3827(8) 



nelt.Hsp.1 2 

nelt.Hap.2 2 

overnight. bin. 2 1 569(16) 

overnight. lisp. 2 1 853(8) 
>er1c-uolf>nail 
>eric-uolf>nenos 
>eric-uol f >n1 cro-courses 
>er1c-uolf>personal 
>eric-uolf>proJects 
>er1c-uolf>sales-course 
>eric-uolf> site-course 
>eric-uolf>ta-job 
>er1c-uolf>u&f -course 
>eric-uolf>uorkbooks 
babyl. text. 2912 52 235112(8) 
baby 1. text. 2913 53 238313(8) 



09/23/86 16:17:2i 
09/23/86 16:17:0 
85/21/85 15:52:1 
85/16/85 11:05:0 
05/16/85 11:01:! 
89/89/86 11:53:3 
09/17/86 18:59:1: 
07/08/85 13:25:1' 
07/08/85 13:21:5: 



Directory oo^r-af jops; 



> cric-wolf>hacks>« ni . r 1 

Delete 



a 1 -hacks 



Open 

Selective open 

Expunge 

Create Inferior Directory 

V iew Properties 

tdit Propertie s! 

New Property 

Create link 

Rename 

Wildcard Delete 

Link Transparencies 



lispn-init.bin. 25 
11spn-1nit.lisp.59 
I1spn-1nit.11sp.60 
thi ngs-to-do . text . 3 
ina1l-1nit.bin. 22 
ina11-1n1t.11sp.63 



I 11/21/86 11:53:12 (11/21/86) 

I 11/21/86 12:89:11 (11/21/86) 

1152(16) 11/11/86 18:35:17 (11/21/86) 

1 3221(8) 89/25/86 10:18:11 (11/14/86) 

1 3153(8) 11/11/86 18:31:18 (11/17/86) 

1 160(8) • 08/11/86 16:55:18 (08/11/86) 

1 1168(16) 89/25/86 15:17:59 (11/21/86) 

1 3285(8) 09/25/86 15:47:55 (18/88/86) 
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File system edit Ing operations 
Tree Edit Root 



Refresh Display 



)U:>eric-uolf >t ,»,« 

>er-1c-uolf>cll-course 



Iree Id it Any 
Help 



Iree Edit home dir 
Local LMFS Operations 



Lisp Window 



iP 



CO 
Cf) 



Change properties for W:>eric-wolf>hacks>speclal-hacks.dlrector77 



Auto Expunge Interval: 1 ueek 3 hours 6 nlnutes 
Default Generation Retention Count: 3 
Default Link Transparencies: WRITE, READ 
Creation Date: 11/21/86 12:18:28 
Author: 'erlc-uolf 
Deleted: Ves Ho 
Don't Reap: Yes Ho 
Don't Delete: Yes No 
Don't Delete Reason: None 



Abort D, 



'<y« 



>er1c-i 

>eric-i 

>er1c 

>er1c-i 

>er1c-i 

>er1c-t 

>er1o-i 

>er1c-t 

>er1c- 

babyl . 

babyl . 

llspn- 

1 1 apn- 

Hspn- 

thlngs 

mall 

znal 1- 



uolf >nenos 

uol f >n1cro-courses 

wolf > personal 

wolf>proJects 

uolf > sales-course 

uo 1 f > s 1 te-course 

uo1f>ta-Job 

uolf >u&f -course 

uolf >uorkbooks 

text. 2912 52 235112(8) 

text. 2913 53 238343(8) 



1n1t.b1n.25 

1Mt.11sp.39 

1n1t.Hsp.68 

-to-do. text. 3 

1n1t.b1n.22 

1n1t.11sp.63 



I 11/21/86 11:53:12 (11/21/86) 

, „„,„>' 11/21/86 12:89:11(11/21/86) 

1 1152(16) 11/14/86 18:35:17 (11/21/86) 

1 3221(8) 09/25/86 18:18:11 (11/14/86) 

1 3153(8) 11/14/86 18:34:48 (11/17/86) 

1 468(8) • 08/14/86 16:55:18 (08/14/86) 

1 1468(16) 09/25/86 15:47:59 (11/21/86) 

1 3285(8) 09/25/86 15:47:55 (10/08/86) 
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File system edit in 
[Tree 



operations 



ReTFe" 



ins operatit 
sh Display 



splay 



3 KENfll -FJORDS :>».».« 



tree tdit Any 
Help 



Free Edit home dir 
Local LMF5 Operations 



Co 

5" 

5" 

3 



SJ 



Lisp Window 



>site 
>sources 






CD 



File system editlns operations 
flree hdit Ko otj 
Kef -■ ' " ' ^ 



e fresh Display 



Iree Edit Any 
Help 



Connand : 

Error: FEP file FEP: >lnf s. f i 

FEP File not found. 

For FEP«:>lnfs.flle 

For JFUH ;>«.».# 



Iree Ldit home dir 
Local LMFS Operations 



Lisp Window 









le.neMest, required for the file systen as a partition. Is not accessible: 



(FLAVOR: METHOD : DIRECTORY-LIST UtFS:LOCHL-Lnf S-DCCESS-HIXIH) : 

Qm Q / CCI C\. tt/l nPQI —I MCCOnprrr nriTii ir-i ir-> • . ~~.~. 



Hrg 

Hrg 1 

Hrg 2 

Hrg 3 

Hrg 4 

H. 

B. 

s-C: 

s-D: 



___..__._.,. .... b ... v . a. vul ii_ ■_■■■«■ nnnLoa- iiiAinj ; 

(SELF): 8<L0CRL-LnFS-RCCESS-PRTH JEWEL using LOCAL-FILE 36?14127> 
<SYS:SELF-MRPPINC-TRBLE): »<nop to flauor LMFS^OCRL-LMFS-RCCESS-MIXIN 2SB531423> 
(FLRUORrs.GEMERIC): : DIRECTORY-LIST m«in 25D531423) 

(LMFS:PflTHMfirtE): KP" JEWEL: >«.* .*■ 
(LMFS:OPTIOMS): ( :MO-EXTRfl-INFO iDELETED) 

Retry DIRECTORY-LIST of JEWEL !>».*.« 

Return to FS Maintenance Lisp Listener in Fsnaint Interaction Pane 1 

FS Maintenance Top Level 

Restart process Fsnaint Frane 1 



. 



Lisp Interaction Window 



CO 



! 
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3. FEP File Structure 
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Pathnames To FEP Files 
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3.1 The FEP Types 

The following file types are used by the FEP file system for files used by the 
system. 



BOOT 

LOAD 

MIC 

FILE 

FSPT 
FEP 



PAGE 

FLOD 
DIR 



Contains FEP commands that can be read by the FEP's Boot 
command. BOOT files are manipulated by the editor. 

Contains a world load image that is used to boot the system. 
Contains a microcode image. 

Contains a LMFS partition. For example, >LMFS.FILE.l is the 
default LMFS file partition. DO NOT DELETE THIS FILE. 
Contains a File System Partition Table. 

The file contains binary information used by the FEP file 
system. These files should not be written to by user programs 
DO NOT DELETE THESE EITHER! Some examples are: 

>FREE-PAGES.FEP 

Describes which blocks on the disk are 
allocated to existing files. 

>BAD-BLOCKS.FEP 

Owns all the blocks that contain a media 
defect and should not be used. 

>DISK-LABEL.FEP 

Contains the disk's physical disk label. The 
label is used to identify the disk and describe 
its characteristics. 

Contains disk space that can be used by the virtual memory 
system. 

Contains FEP software. 

Contains a FEP directory. 
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3.2 Pathnames To FEP Files 

The following are the various forms of pathnames to FEP files: 
fep:>boot.boot 

f ep0 : >Genera-7-0 . 1 oad 

f ep1 : >Genera-7-8 . 1 oad 

arches I fep9 : >Genera-7-9 . 1 oad 

chaos 1 31 542 1 f ep1 : >Genera-7-0 . 1 oad 

3.3 Sizes of things 

One memory word is four eight bit bytes plus four tag bits (36 bits total). 
One FEP block contains 256 36-bit words of data. 
One LMFS record is created from four FEP blocks. 
One page of virtual memory corresponds to 1 FEP block. 
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3.4 Typical FEP Directory 

Command: Show FEP Directory (on host [default KENAI -FJORDS]) KENAI -FJORDS 

Host KENAI-FJORDS: 

Unit 0: 11683 free, 280477/292080 used (96%) 

Lines highlighted in bold represent files currently in use. 

World Load Files: 

FEP0:>in-house-genera-7-0b.load.1 38726 [In House Genera 7.0; IP-TCP 51 .4] 
FEP0:>s4cc-from-in-house-genera-7-0b.load.1 3000 [S4CC, Genera 7.0;IP-TCP 51.4; Exp S4CC 3.1] 

FEP0:>release-6-g.load.1 27539 [Rel6.G, Distribution] 

FEP0:>s4cc-from-release-6-g.load.1 8450 [Re! 6.G, Release-6-7, S4CC 1.0] 

Microcode files: 

FEP0:>3640-mic.mic.394 111 [3640-MIC 394] 

FEP0 : >tmc5-i o4-col -mi c . mi c . 388 112 

Paging files: 

FEP0:>PAGE.PAGE.1 60000 [Paging] 
FEP0:>page1.page.1 30000 [More Paging] 
FEP0:>page2.page.1 30000 [Even More Paging] 
FEP0:>page3.page.1 30000 [Get The Drift?] 

Boot files: 

FEP0:>boot.boot.15 1 
FEP0:>boot.boot.16 1 
FEP0:>boot.boot.17 1 
FEP0:>hello.boot.1 1 
FEP0:>rel6.boot.1 1 
FEP0:>rel6.boot.2 1 

Lisp Machine File System Partitions: 

FEP0:>fspt.fspt.1 1 [LMFS Partition Table] 

FEP0:>lmfs.file.1 49000 [File partition w/ Rel . 6.1 Sources] 

Fep-specific files: 

FEP0:>BAD-BLOCKS.FEP.1 77 [File of bad blocks] 

FEP6:>DISK-LABEL.FEP.1 24 [Disk label] 

FEP0:>FREE-PAGES.FEP.1 32 [Free pages map] 

FEP0:>Reserve.FEP.1 500 [Reserved for future use] 

FEP0:>ROOT-DIRECTORY.DIR.1 2 [The Root] 

FEP0:>SEQUENCE-NUMBER.FEP.1 1 [FEP FS sequence nos] 
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FEP8:>v127-bo1 .flod.33 47 

FEP0:>v127-debug.flod.31 50 
FEPB:>v127-disk.flod.31 29 

FEP0:>v127-info.flod.43 14 
FEP0:>v127-llsp.flod.43 47 
FEP0:>v127-loaders.flod.43 41 
FEP0:>v127-rel7.flod.43 5 

FEP0:>v/127-tests.f1od.43 11 
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Growing A LMFS 

Removing A LMFS Partition 

Salvaging 
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The Most Common 

Catastrophic Mistake That 

System Adminstrators Make Is 

Deleting All Or Part Of A LMFS. 



This Chapter Is Dedicated To 
Those Poor (currently unemployed) People. 



4.1 LMFS Basics 

As you know the LMFS is composed of one or more files in the FEP file structure 
A LMFS cannot be spread across Lisp machines. It can be spread across multiple' 
disks on a Lisp machine. 

On the next several pages we will demonstrate the creation, modification and 
removal of a LMFS. 

Please keep in mind: 

• Never delete part of your LMFS with Delete File 

• Do not delete the FSPT.FSPT file 

• You must have a FSPT.FSPT file on the drive from which you boot 

• Do not delete any FEP file, especially BAD-BLOCKS. FEP 
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5. Fep Commands 
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5.1 FEP Command Summary 

These are the FEP commands you are likely to use. General features of the FEP 
command processor are: 

• Command completion 

• The HELP key shows what commands are possible, given what you've already 
typed in 

• Anything in ()'s is a comment 



5.2 Boot Files 

Boot files are FEP files which contain commands you would like the FEP to 
perform. There are two kinds of boot files: 

• Hello.boot - Contains commands which initializes the FEP after the machine 
has been reset 

• Boot.boot - Contains commands which boot the machine 

Both types of boot files are simple text files which can be easily created in Zmacs. 
Additionally, the Save World command can update a bootboot file for you. 

Although "hello" and "boot" are the standard names for these files, you can give 
them other names if you wish. It is important, however, that you keep the boot 
extension. 
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5.2.1 Hello.boot File 

If your machine has NFEP, whenever you reset the FEP (by entering the Reset 
FEP command or by physically turning the machine off and then on again), the 
following message will appear on the screen: 

Type "Hello" to initialize the Fep's command databases, etc. 

When you type "hello", the commands in the hello.boot file are executed 
sequentially. The hello.boot file typically looks like this: 

Scan FEP8:>V127-info.flod 
Scan FEP0:>V127-loaders.flod 
Scan FEP8:>V127-lisp.flod 
Scan FEPB:>V127-debug.flod 
Initialize Hardware Tables 

Note: Unlike bootboot files, hello.boot files are used only when the FEP is reset 
or the machine is powered-up. We usually have only one, and it is called 
fepO:>hello.boot. By convention, when we talk about "boot files", we usually mean 
"boot.boot" files. 
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5.2.2 Boot.boot Files 

Up to now we have described "booting your machine" as the act of bringing a new 
world into the machine. It actuaUy involves a few more steps. 

Issue the Boot command to the FEP in order to reload the Lisp world If you just 
enter Boot, it will read the commands in the file that you last booted from. 
A boot file should contain at least the first six commands. 

Clear Machine Clears memory and resets various internal hardware caches. 
You must also issue this command when you change the 
microcode. 

Declare Paging Tells the FEP and Lisp processor which files you will use for 
paging. See the chapter Paging and Your Disk Space for more 
information. 

Load Microcode Loads microcode plus various other machine memories. If you 
clear the machine using Clear Machine, you must reload the 
microcode. Symbolics computers will not run without microcode. 

Load World Loads the Lisp environment into the machine. If you have not 

issued a Declare Paging command, it assumes you have a 
page.page file on the same disk as the world you are booting. 

Set Chaos- Address 

Sets the Chaos address for this machine. The machine must 
have a Chaos address set before it can be Started. 



Start 



Starts the Lisp world. This takes a while to figure out how big 
the screen is and so forth, and then clears the screen and 
begins to initialize the rest of the environment. This is always 
the last line in the boot file, since this command tells the Lisp 
processor to take over. 



Enable IDS 



Allows you to create incremental copies of the Lisp world, 
is discussed in the chapter Manipulating Worlds. 



IDS 
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5.2.3 Sample Boot Files 
boot.boot - for everyday use 

(Acme Lisp machine LISPM-17) 

Clear Machine 

Declare Paging fepB:>page aux 

Load Microcode fep8:>3648-mic.mic.394 

Load World fep0:>Genera-7-0-Acme.load 

Enable IDS 

Set Chaos 417 (LISPM-17) 

Start 



small.boot - for use when reconfiguring machines 

(Acme Lisp machine LISPM-17 Small boot file) 

Clear Machine 

(Declare Paging fep8:>page aux) 

Load Microcode fep0:>3648-mic.mic.394 

Load World fep8:>Genera-7-0-Acme. load 

Enable IDS 

Set Chaos 417 (LISPM-17) 

Start 



Note: it's a good idea to put comments in the boot file, so the reader can figure 
out what s required and what's optional. Remember, anything in parentheses in a 
boot file is a comment. 
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5.2.4 Video Control commands 



Set Monitor-Type 



Clear Screen 
Reset Video 



Informs the FEP and the Lisp processor as to what type of 
monitor you have attached to the system. This command will 
not normally be required, since each machine has only one 
console, and knows what type of console it is. Unfortunately, if 
the command is necessary, you won't be able to read the screen; 
it will look like a television with "horizontal hold" problems. 
Should you have this problem, use the Set Monitor-Type 
command and be sure to let your customer service engineer 
know that the machine needs adjustment. 

The two types of monitors Symbolics currently offers are known 
by the name of the manufacturers of their innards. They are 
Philips and Moniterm monitors. 

FEP Command: set monitor-type philips 
FEP Command: set monitor-type moniterm 

Remember that, like Genera, the FEP has command completion. 
For instance, set monitor-type can be abbreviated se m. 

Clears the screen. Pressing Refresh has the same effect. 

Reset the video to the original monitor type. If that was wrong, 
then this will mess the screen up again. 



5.2.5 Commands useful In a crash 



Continue 
Start 

Reset FEP 
Hello 

Show Status 



Continues running Lisp after a Halt 

Warm starts Lisp 

Resets the FEP processor 

Reads the boot file for the FEP processor. Defaults to: 
>hello.boot 

Displays machine state. Often, this will show the problem 
which caused a hardware failure. 
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5.2.6 Other FEP commands 

Show Directory This command displays the contents of the FEP file system. 
For example: 

Fep Command: Show Directory (default is >*) RETURN 



FEP0:>BAD-BLOCKS.FEP.1 578 
FEPG:>boot.boot.4 1 

FEP0:>DISK-LABEL.FEP.1 24 
FEP8:>FREE-PAGES.FEP.1 41 
FEP0:>fspt.fspt.1 1 

FEP8:>hello.boot.1 1 

FEP8:>lmfs.file.1 20800 

FEP8:>lmfs2.file.1 18808 

FEP0:>PAGE.PAGE.1 35000 

FEP0 : >rel ease-6-1 -di st . 1 oad . 
FEP8:>Reserve.FEP.1 1000 

FEP8:>R00T-DIRECT0RY.DIR.1 
FEP0 : >sequence-number . fep . 1 
FEP0 : >tmc5-i o4-mi c . mi c . 336 
FEP0:>v127-debug.flod.1 48 
FEP0:>v127-disk.flod.1 27 
FEP8:>v127-info.flod.2 12 
FEP0:>v127-lisp.flod.2 42 
FEP0:>v127-loaders.flod.2 34 
FEP0.->v127-tests.flod.2 10 



0(8) 

259(8) 

0(8) 

0(8) 

37(8) 

135(8) 

0(8) 

0(8) 

0(8) 



S 



@ 



I 

@ 



06/26/85 19:23:34 [File of bad blocks] 
09/05/85 18:28:40 [] 
06/26/85 19:23:33 [The disk label] 
06/26/85 19:23:34 [Free pages map] 
10/15/85 09:33:35 [] 
10/07/85 18:38:39 [] 
10/15/85 09:31:33 [] 
10/15/85 09:33:33 [] 
06/26/85 19:23:34 [Main paging area] 
1 28277 32563584(8) 10/04/85 17:23:27 [Rel 6.1] 

0(8) 06/26/85 19:23:36 [Reserved] 

2 DIRECTORY § 06/26/85 19:23:33 [His highness] 
1 8(8) 8 06/26/85 19:43:18 [] 
110 125727(8) 09/09/85 10:59:83 [TMC5-I04-MIC 336] 
54613(8) 10/05/85 16:07:47 [] 

30348(8) 10/07/85 09:28:08 [] 

13074(8) 10/07/85 13:33:25 [] 

47434(8) 10/07/85 13:32:12 [] 

38112(8) 10/87/85 13:30:00 [] 

10843(8) 10/07/85 13:34:02 [] 



AKT 

Gaia 

AKT 

AKT 

rsl 

rsl 

rsl 

rsl 

AKT 

LISPM 

AKT 

AKT 

AKT 

rsl 

SWM 

SWM 

SWM 

SWM 

SWM 

SWM 



Note: the e in the display indicates that the Don't Delete bit is set. 



Shutdown Powers down the machine. 

Show Configuration 

Tells you the machine serial number. ECO levels, date of 
manufacture, etc. 

Compute Microcode Default 

Looks at the hardware and tells you the right microcode for this 
configuration. 

Show Paging Lists the files currently declared as paging files. 

Mount Makes available a disk not otherwise referenced in a boot file. 

Place it before the Start command. For example: 
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(Acme Lisp machine LISPM-17) 

Clear Machine 

Declare Paging fep0:>page pagel 

Load Microcode fep0:>3640-mic.mic.394 

Load World fep8:>Genera-7-0-Acme.load 

Enable IDS 

Set Chaos 417 (LISPM-17) 

Mount FEP1: 

Start 
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6. Paging And Your Disk Space 



Creating More Paging Space 

Removing Paging Space 

Capacities Of The Various Drives 

Rules Of Thumb For Allocating Space 

LMFS and Paging Lab 
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6.1 Creating More Paging Space 

By enlarging your paging area you increase your consing space. This greatly 
decreases the frequency with which you must garbage collect. For every ten 
thousand blocks of paging file you get 2.5 million words of paging space. 

To get more room for paging, delete and expunge unused files from the fep file 
system. Old world loads, boot files, old microcode files. Consult your boot.boot 
file for the names of your present world load, paging and microcode files. Do not 
delete the world vou are running or the natrin g files von are tnirrpnt.lv nsing 
EVER! . 

Find out how much free space is left in your fep file structure. You can use the 
Show Fep Directory command and round down to the next lowest thousand. 
Please note: 

• Show Fep Directory does not display deleted files. 

• Don't forget about FEP1. 

Use the command Create FEP Fi le to create an empty file of that size. Below is 
an example. Notice the .PAGE extention. 

Command : Create FEP File fepO:>pagel.page 35000 

Edit your boot file and add the following line before the "Load Microcode" 
command. If there is already a declare paging command there, simply add pagel 
to the command. If the Declare Paging command is not there, you will have to 
add the entire command. 

Declare Paging fep0:>page pagel 

At this point you have two options: 

1. Halt and boot your machine. Look at the herald to see how much you've 
gained. 

2. Use the Rdd Paging File command to add the paging file without booting. 
The herald will not show the updated swap space, but it is there. 
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6.2 Reducing Paging Space 

When the machine is up and running it is using all the paging files added by the 
boot file. In order to reduce the size of your paging you cannot simply delete one 
of your paging files. You should follow these steps: 

Getting rid of an extra paging file: 

• Edit your boot file to remove the extra file from the Declare Paging 
command 

• Boot the machine 

• Delete the extra paging file and expunge the FEP directory 



Reducing the size of your only paging file 

• Create a new paging space of the correct size 

• Edit your boot file to use the new paging file 

• Reboot using your new paging file. 

• Delete the old paging file and expunge the FEP directory 

6.3 Capacities Of The Available Disk Drives 

□rive Cap. Approximate Useful Space 



148Mb 


110,000 blocks 


19BMb 


150,000 blocks 


300Mb 


250,000 blocks 


368Mb 


290,000 blocks 


474 Mb 


370,000 blocks 
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6.4 Rules Of Thumb For Allocating Space 

• You must always have on disk the world you are running and the paging 
file(s) you are using. 

• When changing to a new world, it is good to keep an old world around until 
you are sure you like the new one. 

• For every four blocks of disk you allocate to paging you get one kiloword of 
paging. 

• Paging files should be 35 to 40 thousand blocks so they can be swapped for 
world loads easily. If your site has larger world loads (because of layered 
software you install) adjust the numbers accordingly. 

• It is a good idea to have two smaller paging files instead of one big one. It 
makes it easier to bring in new world loads. 

• Convert any unused disk space to paging space. 
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6.5 LMFS and FEP Lab 

Booting your machine by hand 

Read your bootboot file by selecting a Lisp Listener and using the Show File 
command or by reading the file into an editor buffer. Write down each step in 
the bootboot file. Logout, do a Halt Machine, and boot the machine by hand. 
Making an auxiliary paging file 

1. Use the command Show FEP Directory to determine the number of free 
blocks you have. 

2. Go to FSEdit and click on [Tree Edit Any] and specify FepQ :>*.*.* to edit 
the FEP directory. 

3. Expunge Directory FEP0:>*.*.* . Now, go back to a Lisp Listener and use 
Shou FEP Directory to see how many blocks you have available . 

4. Use the Create FEP File command to create an auxiliary paging file Make 
sure to leave 1000 blocks free in your FEP directory. Create an auxiliary 
paging file by entering the following command processor command: 

Create Fep File pagel.page *number-of-blocks* 

where *number-of -blocks* = (number of free blocks - 1000). 

Please note: 

a. We're leaving 1000 blocks stiU free in order to have room to update 
files and create new files. 

b. If you already have a file called "pagel.page", name the file something 
else.. ..be creative. 

c. Before continuing, check the size of your swap space by doing a Show 
Herald. Write it down here. 
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5. Edit your boot file to add the new paging file. 
Declare Paging FEPn:>page FEPn:>pagel 

6. Where n is the disk that file is on. 

7. After saving your boot file, logout and cold boot. How much extra swap 
space did you get? 

Practice with LMFS partitions 

1. Click left on [Initialize] in the level 3 FSEdit menu to create a LMFS 
partition of 500 blocks. 

2. Click right on [Initialize] to create an auxiliary LMFS partition (100 blocks). 
Give the new partition a meaningful name, eg. lmfsl.file, instead of the 
default, xyzzy.file. 

3. Look at the FEP directory to see if the new partitions have been created. 

4. Look at the file fspt.fspt. 

5. Click left on [Tree Edit Root] to open the (new, empty) LMFS. Click right 
on the machine name and choose Create Inferior Directory from the pop-up 
menu. Supply your login name as the name of the new directory. 

6. Go to the editor and read in or create a file, then save it in your new local 
directory. 

7. Go back to FSEdit and click on [Grow Partition]. Make the auxiliary 
partition 100 blocks bigger. 

8. Use [Tree Edit Any] to edit the FEP directory. 

9. Use the [Edit Properties] menu item to add a comment to your auxiliary 
lmfs partition's directory entry. 

10. Remove your auxiliary partition. Look at fspt.fspt once again. 
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7. Tapes 



Kinds of Tapes 

Carry Tapes 

General Backup Theory 

Full Backup 

Incremental Backup 

Consolidated Backup 
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7.1 Kinds of Tapes 

The Lisp machine supports four kinds of tapes. It is important that you 
understand their differences so that you can use the correct kind for a given 
application. 

1. Carry Tape - Used to transport files 

2. Backup Tape - Used to save the contents of your file server's directory in 
order to be able to recover accidentally lost files at a later date 

3. FEP Tape - Used to transport FEP files and world loads 

4. Distribution Tape - Used to transport software systems and layered products 
Distribution tapes will be discussed later in the course. 

7.2 Pathnames and Wildcards 

A pathname using wildcards might look something like this: host:>**>*.*.* 

host Is the machine you are sitting at 

Match any component of a pathname 
*■*•* Match any name, any extension and all versions 

Match all subdirectories (at any level). 

What do you think the following pathnames would refer to? 

HOST:>*>*.*.* 

HOST:>*.*.* 

HOST:>SYS>*>*.*.* 

HOST:>SYS>**>*.*.* 
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7.3 Using Carry Tapes 

The cany tape system is very simple way of transporting files from one Lisp 
Machine to another (or one site to another). You should not use backup tape for 
this purpose. There are two useful functions: tape:carry-dump puts files onto a 
tape, tape:carry-load restores them to the Lisp Machine. 

7.3.1 How to make a carry tape 

The function tape:carry-dump copies files from the LMFS (Lisp Machine File 
System) to a tape in the tape drive of the local machine. Tape:carry.dump takes 
one argument: a list. The list consists of the pathnames of the files to be 
dumped. 

Next it will list the directories to be dumped, tell you the total number of files 
and ask if this is OK If you want to make the tape, answer Yes. 

Then it will prompt you with a long bunch of information about the "tape soec" 
just press RETURN. ' 

Tape one file: 

(tape: carry-dump ' ("c:>eric-wol f>l ispm-init. 1 isp")) 

Tape all files at top level in eric-wolf's directory: 
(tape .-carry-dump ' ("c:>eric-wolf>*. *.*")) 

Tape the newest version of the lisp programs in eric-wolfs directory: 
(tape: carry-dump ' ("c:>eric-wolf>*. lisp. newest")) 

Tape everything in eric-wolf and cgay's directories: 
(tape: carry-dump ' ("c:>eric-wol f >*.*.*" "c:>cgay>*. *.*")) 

Tape everything in eric-wolf's directory and all it's subdirectories: 
(tape: carry-dump ' ("c:>eric-wolf>**>*. *.*")) 

Dump everything on the host "c" (not recommended, it will be BIG): 
(tape : carry-dump ' ( " c : >**>* .*.*")) 
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7.3.2 How to reload a carry tape 

Go to a machine with a tape drive. Put the tape in the tape drive. Go to the 
machine's console and run the function tape:carry-load, buy typing 
(tape:carry-load) in a Lisp Listener window. 

First it will print a long "tape spec" and allow you to change it. As when you 
were dumping the files, just press RETURN. 

The program will print a summary of what is on the tape and then ask you what 
you want to do with the first file. You have four options: 

Y Reload the file to the default place. 

N Don't reload the file. 

O Reload the file to some other place (you are prompted to enter 

the new pathname). 

A Reload the file (and the rest of the tape) to the default place 

without further prompting. 

The system will take the appropriate action and then go on to the next file on the 
tape. 
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7.4 General Backup Theory 

As the site administrator one of your major ongoing responsibilities is to backup 
the Lisp machine file system on a regular basis. This is THE task you cannot let 

S 1.10.0. 

SS?* 1- ^ 1 ? UP ^ ^ SySt6m y ° U ^ be WOrkin « "^ the level tw <> menu of 

rJ™n ? nng * UP PfeSS SELECT F and Click on the level one ™™ item Local 
LMFS Operations. 

There are three kinds of backup dumps available to you: 
Complete Copies to tape all files and directories specified 

Incremental Copies to tape aU files and directories that have been created or 

modified since the last backup 

Consolidated Copies to tape aU files and directories that have been created or 

modified since a date you specify 




File syste m editing operations 
Iree Edit Root 



Refresh Display 



Uisplay I ape Map 

Flush Free Buffer 

Exit Level 2 



'stem control operations 
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Help 



Iree Edit home dir 
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Lisp Window 
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List Backup Tape 

Close All Files 

LMFS Maintenance Operations 



Consolidated Dump 

Compare Backup Tape 

Expunge local LMFS 



Read Backup Tape 
List FEP FS Root 
Server Shutdown 



Find Backup Copies 
Free Records 
Server Errors 



Lisp Interaction Window 
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Server Shutdown 
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Free Records 
Server Errors 









Conplete 



Halkato) 

fl tape nane nust be specified. 

Dunp Type: Inerenental Consolidated 

Pathnames: U: >«»>».«.* 
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Dunp deleted files: Yes No 
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Pathnanes: U:>**>«.*.» 
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Tape Drive Spec: Local: cart, den=3200 

Dunp deleted files: Yes No 

Tape when done: Offline Rewind Leave 

Person operating: "File-Server" 
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Tape Reel ID: HIMC081 

Tape Drive Spec: Local: cart, den=3280 

Dunp deleted Tiles: Yes Ho 

Tape uhen done: Offline Rewind Leave 

Person operating: "File-Server" 

Set date dumped: Yes J1o 

Restart pathnane: a nwl or type 

Connent: For SITE class 
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Ended pass over U:>**>*.*.* 



47 files dunped. 

Increnental dunp conpleted at 11/24/86 13:59:35. 

Setting backup dates for files Just dunped. 

Can't set backup dates for H: >er1c-wolf )na1 1 .text.l : The file was not found 
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Creating U:>dunp-naps>u1nc86l .directory. 8 

Backup dunp of 11/24/86 13:15:2? conpleted. 
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7.6 Finding and Restoring Files 

There are a variety of tools which help make restoring files from backup tapes 
relatively painless. 

7.6.1 Displaying a Dump Map 

When the backup program runs, it creates a file, called a dump map. A dump 
map lists all the files which have been placed on a particular tape. The [Display 
Tape Map] command lists all of the files which were dumped on a particular tape. 

7.6.2 Finding Files on a Backup Tape 

As you might imagine, searching through many dump maps (to find out which 
tape contains a particular file) could be a long and tedious process. The [Find 
Backup Copies] command, on the level 2 FSEdit menu, does the work for you It 
prompts you for a pathname and then searches all of the dump maps for files 
matching that pathname. It then prints a list of all matching files and the tape(s) 
on which they appear. «*fc W 

7.6.3 Restoring Files from a Backup Tape 

Once you have found out which tape contains the file(s) you wish to restore, you 
can use the [Read Backup Tape] command to restore them. [Read Backup Tapel 
allows you to specify a pathname and then restores all files on the tape which 
match the pathname. 
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7.7 FEP Tapes 

FEP Tapes are used to transport worlds and microcodes. Symbolics is the 
heaviest user of FEP tapes, we distribute new releases of Genera that way. In 
general, a FEP Tape consists of one or more microcode files followed by one or 
more world loads. 

7.7.1 Reading FEP Tapes 

FEP Tapes can be read in two ways. 

1. From the FEP, using the Disk Restore command. 

2. From Lisp using the FEP-Tape activity. 

Being able to read FEP tapes from the FEP is important. If you accidently delete 
the last world load on your disk and then halt your machine, you would return 
your system to a working configuration by restoring a world from tape using the 
FEP's Disk Restore command. 

On the other hand, reading FEP tapes from the FEP is somewhat cumbersome, so 
most often we use the FEP-Tape activity to read them. 

7.7.2 Writing FEP Tapes 

FEP Tapes cannot be written from the FEP, they can only be written from Lisp 
(usually, using the FEP-Tape activity). You should write a FEP tape to keep a 
backup of the world which comes on your system (normal backup procedures only 
backup files in the LMFS). You might also write a FEP tape in order to transfer 
a world between two, unconnected machines at your site. 

7.7.3 The FEP-Tape Activity 

Start the FEP-Tape activity by typing the command Select Activity FEP-Tape to 
a Lisp Listener (it is not selectable from the SELECT key or the system menu). 

To read a FEP-Tape, just type the command Read Tape. The system will read 
through the tape and ask you whether you want to restore each file. Be sure to 
have enough space on your FEP file-system for all the files you want to restore. 

To write a FEP-Tape, you first use the Add File command to create a list of all 
the files you wish to dump. Put the microcode file(s) first, followed by the world 
load(s). Next, use the Write Tape command to actually write the tape. Since 
each tape hold approximately 20 megabytes, it takes 2 tapes to hold one microcode 
and one world. The program will stop after it has finished the first tape and wait 
for you to put the second tape in the tape drive. 
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7.8 Periodic Tasks 

7.8.1 Cleaning Up The Dump-Map Directory 

The backup program places its dump maps in the dump-maps directory on the file 
server. For example: 

server : >DUMP-MAPS>compl ete-9/1 5/86-9 : 82 . MAP . 1 

server :>DUMP-MAPS>coma081.DI RECTORY. 1 

The MAP files are character files. One is created per dump and it records the 
dump m a human readable form. The DIRECTORY files are binary files One is 
created per reel of tape (a single dump may consist of many reels of tape). 
These files take up space. Every few months you may want to go into this 
directory and delete and expunge the files for which you have already recycled the 

U3.p6S. 



7.8.2 Checking Your Tape Hardware 

It is possible that hardware problems can cause bad backup tapes to be written 
without any error being detected. Therefore, it is important that you compare ' 
your backup tape with the LMFS. You can do this with the FSEdit menu option 
Compare Backup Tape. 
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8. Manipulating Worlds 



Creating A New World 

Incremental Disk Save 

Copying Worlds 

New World Lab 
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8.1 Creating A New World 

Your Lisp World is initially defined by the contents of the world load file which 
you choose to boot. If you wish some piece of software to always be available you 
can make it part of a world load. To do this you follow these basic steps: 

• Make sure you have room in the FEP file system for a new world 

• Boot the world you wish to start with 

• Start the ephemeral garbage collector 

• Log in as the generic user. 

• While doing as little else as possible, load the software you wish to be part 
of the world 

• Possibly run the dynamic or immediate garbage collector 1 

• Enter the Save World command 
For example: 

Command: Show FEP directory 

Host KENAI -FJORDS: 

Unit 8: 44698 free, 65462/118168 used (59%) 



Command: Logout 
Command: Halt Machine 

Fep Command: Boot 

Command: Start GC : Ephemeral Yes 

Command: (si : login-to-sys-host) 

Command: Load File kenai-f jords:>fred>my-expert-system.bin 

Command: Start GC : Immediately Yes 

Command: Save World Complete fep8:>fred-expert-7-0.1oad 



See the chapter on Garbage Collection 
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8.2 Incremental Disk Save 

Incremental disk save (IDS) lets you save only the changed part of the world. 
To create an IDS world, follow these steps: 

• Boot a clean world making sure your boot file contains the command Enable 
IDS. This permits the Lisp Machine to record those pages which have 
changed since cold boot, so that only those pages have to be dumped to disk. 

• Turn on the Ephemeral garbage collector: Start GC :E P heneral 

• Make the changes to your world 

• Save your world: 

Command: Save World Incremental fepB: > new -world-name, load 

• Save World will offer to update your boot file 

Even Incremental take more disk room than the files which comprise them, but 
much less than complete world loads. They are also much quicker to boot than 

load) ^ tSke t0 l0ad ^ meS (UnleSS the fll6S take ° nly a few seconds t0 

Note: Do not do an immediate, dynamic or full garbage collection before saving an 
incremental world. This vastly increases the size of the world. The garbage 
collector is discussed in chapter 11. 

8.2.1 Parents and their Children 

An IDS world is called the child and the main world associated with it is its 
parent One parent can have several children (eg. Pascal world and Macsyma 
world). Children can have children as well. 

To boot a IDS world all the ancestors must be present on that machine. If you 
accidentally delete a world that has children you can never boot those children. 

When you load an IDS world, it automatically finds its parent. If you boot a world 
which has children, you don't get the children. 
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8.3 Copying Worlds 

Once you've created your world, you may want to copy it to another machine. You 
copy a full world or an IDS world with the same command: 

Command: Copy World source-world destination-world 

You can be on sending or receiving end. You must specify the complete pathname 
for the world at the other end. Here are some examples: 

Copy World fepl :>genera-7-8. load fep8:>genera-7-B.load 

Copy World fepl :>genera-7-8.1oad arches |fep0:>genera-7-0. load 

Copy World redwood | f ep1 :>genera-7-8. load fep0:>genera-7-0. load 



A complete example: 

Copy World arches|fepl:>genera-7-0.1oad fep0:>genera-7-0.1oad 

Copying from Arches to local host; 

Using the fast blast protocol. 

Remote band is 

FEP1:>genera-7-0.load.1 35337 40708224(8) 8/27/86 07:45:84 [Genera 7.8] LISPM 

Do you really want to receive 35337 remote file blocks starting at block 
to local file? (Yes or No) Yes 

100 200 300 488 38500 38600 38726 

Checksumming the entire file. 

100 288 380 408 38580 38600 38726 

No bad blocks were found. 

Do you want to update the boot file to load fep0:>genera-7-0.1oad (Yes or No) Yes 

Boot file to update (Default FEP0:>boot.boot) RETURN 
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8.4 New World Lab 

1. Your machine should have a configured world on it. A configured world load 
file will have a name something like this: "FEP0:>Genera-7-0.1oad". Don't 
use the world named something like: "FEP0:>Genera-7-0-dist.load". 

2. Be sure you have 35000 free blocks in the FEP directory. If you don't, 
delete the files you think can be deleted to make the room. Do NOT 
expunge them until you have the instructor or TA's go ahead. 

3. Take a configured world and boot it. Change the mouse documentation line 
to be inverse video by using Function n-C. This is the place where you are 
changing the Lisp World. You could be loading an expert system or 
compiling some code, this is just a short, simple change. Now, Save World 
Complete. Boot the new world to see that it works and that the change to 
the mouse doc line was permanent. 

4. Delete the disk-saved world (You'll have to boot the original world first) 
Change the mouse documentation line to be inverse video. Do a Save World 
Incremental, and boot that new world. Don't delete this new world. 

5. Use Select E to select the editor, Zmacs. Type in a few lines of text. Select 
the Lisp Listener. Save World Incremental again. Boot the new 
incremental world. Look at the editor. Do you see why you cannot use the 
editor when you are creating worlds? Don't delete this new world either. 

6. Pick a partner in the class. Use the Copy World command to move the last 
incremental world you made to your partner's machine. Boot the copied 
world. Does it work without its ancestors? 

7. Delete all the world loads that you made. 
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9. Site Configuration 



What Is A Namespace? 

FEP Tape 

Distribution Worlds 

Configured Worlds 

What Happens When You Boot A World 

Configuring a Site 

Adding Users 

Adding Hosts 

Site Configuration Lab 
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9.1 What Is A Namespace? 

There are many things about a site that are important for any host to know, such 
as where to deliver a user's mail, what host the user's home directory is on, and 
what host(s) provide hardcopy service. 

The Symbolics system maintains a database of such information called the 
namespace database. This database is maintained by a single host on the network, 
called the namespace server. 

Each Lisp Machine has a copy of the namespace database in memory. However, 
only the copy on the namespace server is guaranteed to be completely up-to-date. 

Whenever you do something that requires using the namespace database, the 
system will use the local copy unless it thinks that the namespace server has more 
up-to-date information. 



9.2 Namespace objects 

The namespace database is a collection of objects. Each object a name, some 
attributes, and is a member of a class. The classes are: 

h °st A host object represents any computer, usually connected to a 

network. 

user A user object represents a person who uses any of the hosts. 

network A network object represents a computer network, to which some 

hosts are attached. 

printer A printer object represents a device for producing hardcopy. 

site A site object represents a collection of hosts, printers, networks 

and users that are grouped together in one physical location. 

namespace A namespace object represents a mapping from names of objects 

to the objects themselves. 

You can add objects to the database and modify them by using the namespace 
editor, which can be selected by using the command Edit Namespace Object or 
through the System Menu. 

For example, you might connect a printer whose name is jenny-lake to the host 
whose name is cascades. You must then alter the printer attribute of the host 
cascades to be the printer jenny-lake. 
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9.3 Servers and Using Services 

It would seem at first glance that each Lisp Machine would need its own printer 
This is quite impractical. Typically, there are several Lisp Machines at a site but 
the site only needs one printer. * 

One host will have a printer attached to it, and it will provide hardcopy service for 
the other hosts on the network. 

Using Services 

To use a service that a particular host provides, your host will send a request over 
the network to the server host. The server will perform the requested operation 
and, if required, respond to the sender. 

Most Lisp machines will provide the following services: 

File Access to files 

Lispm-finger Who is on this machine 

Show-users Who is on this machine 

Send Converse 

Login Remote login 

Uptime How long has this machine been up 

Time What time is it 

Chaos-status Are you there? 



In addition at least one machine at your site should provide these services: 

Namespace Namespace queries answered 

Mail-to-user Mail handling 

Hardcopy Printing things 
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9.4 Worlds 

A world load file contains a complete Lisp environment. At boot time the world 
load is brought into memory and begins to run. What is in your world load 
determines what will happen when you boot. There are two kinds of world loads: 
Distribution worlds 

• A distribution world is the plainest kind of world load file. 

• Distribution worlds are sent to you on FEP tape. New microcode might also 
be on the FEP tape. 

• Distribution worlds are at a site called Distribution. 

• Distribution worlds don't try to do any operations that would require site- 
specific information while booting. 

• Distribution worlds must be Configured to make them useful. 
Configured worlds 

In addition to the normal Lisp environment, a configured world contains all the 
information that the namespace had when it was configured. 

This information includes: 

• What site the machine is at 

• Information about all the hosts it knew about 

• Identity of the namespace server 



9.5 Booting a world 

When you boot a configured world: 

1. A request for the time is broadcast 

2. If this is a namespace server, it reads in the namespace database. 

3. If not a namespace server, the namespace server is asked about the identity 
of the machine and then for any updates to the namespace. 

When you boot a distribution world: 
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1. A request for the time is broadcast 

2. Machine doesn't ask any namespace questions 

3. You use the "Set Site" command to establish the machine's identity. 



86 

Site Maintenance November 1986 



9.6 Configuring A Site 

In this section we will go through a complete site configuration. Our site will 
consist of two 3640's and one 3670. We will assume you are starting from 
scratch. The general outline that we are going to follow is: 

1. Plan the site 

2. Restore the distribution world from tape to disk 

3. Create the site on the 3670 

4. Add the other machines to the site 

5. Configure the namespace server world on the 3670 

6. Configure a non-namespace world on the first 3640 

7. Copy that world to the other 3640 

Normally, you plan and create a site only once, when you first get your 
machine(s). However, you configure machines for you site (steps 2 and 5 thru 8) 
each time you get a new a new distribution world (usually when Symbolics creates 
a new major release of the software). 
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9.7 Step 1 - Plan the site. 

We have decided to call our site Acme. Our site has three Lisp Machines which 
we 11 call Lispm-1, Lispm-2, and Lispm-3. 

Lispm-1 (the 3670) will be the file server, the namespace server and the SYS host 
because it has the most disk space and the only tape drive at the site. 

We must assign Chaos addresses, nicknames, and pretty names: 
Name Chaos address Nickname Pretty Name 

Lis P m - 1 401 LM-1 Lisp Machine 1 

Lispn1 - 2 402 LM-2 Lisp Machine 2 

Llspm - 3 403 LM-3 Lisp Machine 3 

Whenever you want to refer to a machine (eg. in a pathname), you can type the 
machine s nickname instead of its full name. 

The machine's pretty name appears in the herald when you cold boot. 
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9.7.1 Chaos Addresses 

A Chaos address is a 16-bit quantity, in which the high-order 8 bits represent the 
subnet number, and the low-order 8 bits represent the host number on that 
subnet. Chaos addresses are expressed in octal. 

We must choose a Chaos subnet number which will apply to all of the machines at 
our site, plus a different host number for each machine at our site. 

We choose subnet number 1 for our site and host numbers 1, 2, and 3 for Lispm-1, 
2, and 3, respectively. These give us Chaos addresses 401, 402, and 403. 

Example: Chaos Address 403 

15 14 13 12 11 18 9 8 7 6 5 4 3 2 1 
+—+___+___+___+___+___+ + ___ + + ___ + +___+___ + ___ + ___ + ___ + 

I0I0I0|0|0|0!0|1|0|0|0|0|0|0|1|1| 

+ + + + + + + + + + + + + + + ___ + + 

|< Subnet Number >|< Host Number 1 
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9.8 Step 2 - Restore the distribution world from tape to disk 

If you are installing a new machine, you should skip this step. New machines 
arrive with a distribution world already on the disk. This step is necessary only if 
you are installing new software on an existing machine. 

If you are running Genera 7.0 already, you can restore the world from tape using 
the FEP-Tape activity (described in Chapter 7). If you are still running Release 
6.0 or 6.1, follow these instructions to restore the world from tape. The tape 
should be accompanied by a specific list of its contents and what you need to 
restore. In general: 

• Put the first FEP tape into the drive. 

• Create a FEP file to hold the new world: 

Command: Create FEP File (FEP File) fepO:>Genera-7-0-dist.load 

(Size in Blocks) 35000 

Command: Logout 
Command : Halt Machine 

• Clear the machine and load the microcode. 

• Scan the disk flod file, then disk restore the contents of the tape: 

Fep Command: Clear Machine 

Fep Command: Load Microcode tmc5-io4-st506-mic.mic.336 

Fep Command : Scan fep0:>vl27-disk.flod 

Fep Command: Disk Restore 

• When you are asked about restoring microcode, you usually enter S(kip) 
since most of the microcodes on the tape are for machines configured 
differently from yours. When you see the correct microcode for your 
configuration, you answer Yes. You can determine the correct microcode 
from the instructions accompanying your tapes. 

• After the first tape has finished you will see the message, "End of 
restoration tape encountered." Simply put in the second tape and do another 
disk restore; the system will continue at the proper place. 
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9.9 Step 3 - Create the site 

Cold boot the 3670 by hand -- it will become the namespace server. 
FEP Command : Clear Machine 

FEP Command: Load Microcode (default: >3670-MIC.MIC) 

FEP Command: Load World (default: >Released-World.load) >genera-7-0-dist.load 
FEP Command: Set Chaos 401 
FEP Command: Start 

Create the LMFS on LISPM-1 (if one does not yet exist). 
Login using (si:login-to-sys-host) 

click on [Initialize] in FSEdit level 3 menu 

Partition FEP8:>lmfs. file. newest does not now exist. It will be created 

Number of blocks to allocate? 10000 

Created FEP0:>lmfs.file.1 . 

Proceeding with the initialization of partition in FEP0:>lmfs.file.1 . 

Zeroing FEP0:>lmfs.file.1 , 10000 blocks. 

Partition initialization complete. 

Create the site: 
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Command: Set Site (site name) acme 

Define a new site named ACME (as opposed to looking for an existing 

definition of ACME on disk?) (Yes or No)? Yes 
What host is to be a namespace server for ACME (default: LOCAL) RETURN 
What host is to be the SYS host for ACME (default: LOCAL) RETURN 
What folios computer will store the namespace data files for ACME (default: LOCAL) 

xtE/l UKJN 

What host is to be used for bug reports for ACME (default: LOCAL) RETURN 
What is the real name of the local host: lispm-1 

What d1r RET^r LISPM " 1 Win h ° ld the namespace data fi1es (default >^>^»-- 

What directory on LISPM-1 corresponds to SYS: SITE; (default >sys>site» -RETURN 

What account should be used for the system to login to LISPM-1 
(default: lispm): RETURN 

What is the local timezone (default: EST):RETURN 

Is ACME a stand-alone site (there are no servers to respond to a 

Who-am-i request)? (Y or N) N 

Created CHAOS | 481 :>sys. 

Created CHAOS | 481 :>sys>site. 

[13:24:33 Namespace Lock CHA0SI481: reloading namespace ACME. 

Recent servers contacted are CHAOS 1 481] 
[13:24:41 Namespace ACME has become unloaded: 

No longer server for this namespace. 

Recent servers contacted are DIS-LOCAL-HOST] 

The local host is now LISPM-1. 
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9.10 Step 4 - Modify the site as needed 

Since we know there are two other machines at this site, we can add them to the 
namespace database now. 

Add Lispm-1's short name: 

Command: Edit Namespace Object (a namespace class or a token) 

Host (name) lispm-1 
click on [name after Short Name] 

Attribute: Short Name 

Description: Shorter names, used for input or output 

LM-1 

click on [Save] 

Create Lispm-2 (we're still in the namespace editor): 
click on [Copy] 

Enter a name for the host to be created: lispm-2 
click on [401] in the CHAOS address 
Attribute: Address 

Description: A network address for this host. 
402<return> 

click on [LM-1 after Short Name] 
Attribute: Short Name 

Description: Shorter names, used for input or output 
LM-2 
click on [Save] 

Do the same for Lispm-3 (not shown here), using its chaos address. 
The new site has now been created. 
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9.1 1 Step 5 - Configure the namespace server. 

In the process of creating the site, you also created a lot of garbage It is 
necessary to cold boot the machine prior to configuring a world on the namespace 
server. Now is a good time to update the boot.boot file. 

Command: Edit File (file [Default: ...]) fepO:>boot.boot 

Delete the Chaos address (probably 52525) and insert the correct address (401, in 

tfllS C3.SGJ. 

You may also have to change the world which is loaded: 
Load World fepO:>Genera-7-0-dist.load 

Once you have saved this file, log out and cold boot the machine. 
After a while, the machine will display the initial window and ask for your 
command. You must now do another set site, in order to configure the 
distribution world for the namespace server. 

Command: Set Site (site name) acme 

Define a new site named ACME (as opposed to looking for an existing 

definition of ACME on disk)? (Yes or No) No 
What host is a namespace server for ACME (default: Local): RETURN 
Where is the descriptor file for ACME 

(default: local :>sys>si te>acme-namespace. text) • RETURN 
Assuming that LISPM-1 is the real pathname host name of the local host 
[Warning: the local host, DIS-LOCAL-HOST, was not known to have that 

name] 
[13:28:18 Namespace lock LISPM-1: Reloading namespace ACME. 

Recent servers contacted are LISPM-1] 
[13:28:24 Namespace ACME has become unloaded: 

No longer server for this namespace. 

Recent servers contacted are DIS-LDCAL-HOST] 

The local host is now LISPM-1. 
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Save The Configured Server World 

Command: Save World (Complete or Incremental) Complete 

(on FEP file [default FEP0:>Genera-7-8.1oad]) Genera-7-O-Server 

Symbolics Genera, FEP0:>Genera-7-0-Server.load.1 

3670 Processor, 1024k words Physical memory, 15000K words Swapping space. 

Genera 7.0 

Acme LISPM-1 

Are you satisfied with this herald? (Y or N) Y 

The title for this world on the disk is "Genera 7.8", ok? Y 



Do you want to update the boot file to load FEP0:>Genera-7-0-Server.load.1? (Yes or No) 

Yes 
Boot file to update (default FEP0:>Boot.boot) : RETURN 



. _ ___^__ 95 

November 1986 ' " " ~ ~ . — 

Site Maintenance 



9.12 Step 6 - Configure a non-server world on LISPM-2 

First, cold boot the machine by hand. 
FEP Command: Clear Machine 

FEP Command: Load Microcode (default:>tmc5-io4-st506-mic.mic.336)364O-mic mic 
FEP Command: Load World (default: >World1 .load) >Genera-7-0-dist.Ioad 
FEP Command : Set Chaos 402 
FEP Command: Start 

Fix up the boot file and make room for the new world load. 

Command: (si:login-to-sys-host) 

Command: Edit File (file [Default: ...]) fepO:>boot.boot 
Delete the Chaos address (probably 52525) and insert the correct address (402 in 

rnl T°\J f f U j^ t ,°, USe Incremental Dii * Save, you can also insert Enable 
IDS after the .Load World command and before Start. Also make sure the boot 
file doesn't add aux.page. 

Save the file with c-X c-S, and return to the Lisp Listener with SELECT L. 
Now, make room for the new world: 

Command: Delete File FEPO:>aux.page 
Command: Expunge Directory FEP0:> 

FEP9 :>*.*.*: 35008 blocks freed. 

Now, shut down the machine and boot it again. Since you used the text editor 
you must cold boot again before building a world you intend to save This is a 
good time to test the boot file you just wrote. 

Command: Logout 
Command: Halt Machine 

Do you really want to halt the machine? (Yes or No) Yes 

Lisp stopped itself. 
FEP Command: boot 

After a while, the machine will display the initial window and the Command- 
prompt. 
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Command: Set Site (site name) acme 

Define a new site named ACME (as opposed to looking for an existing 

definition for ACME on disk)? (Yes or No) No 
What host is a namespace server for ACME (default: Local): lispm-1 
Chaosnet address for lispm-1: 401 
Host responds as LISPM-1, ok? (Y or N) Y 

After a short pause: 

The local host is now LISPM-2. 
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Save The Configured Non-Server World 

Note: If there were site-specific software you wanted in the world, this would be 
the time to load it. Such software might be the color software or other Symbolics 
"Layered Products", software you purchased from a third party, or software you 
have written which you want to be a basic part of your world. 

Command: Save World (Complete or Incremental [deaf ult Complete]) Complete 
(on FEP file [default FEP8:>Genera-7-0.1oad]) 
Genera-7-O-Acme 

Symbolics System, saved into FEP0:>Genera-7-0-Acme.load 

3640 Processor, 1824K words Physical Memory, 17360K words Swapping Space. 

Genera 7.0 

Acme LISPM-2 

Are you satisfied with this herald? (Y or N) Y 

The title for this world on the disk is "Genera 7.0", ok? Y 

New estimated size is 35887 blocks. 
Logging out . . . 

Running BEFORE-COLD initializations 
System Shutdown ... 

The screen is cleared. 

Note: Servers are currently disabled. 

Saved to FEP0:>Genera-7-0-Acme.load.1 , size is 35789. blocks 

Update boot file to load FEP0:>Genera-7-0-Acme.load.1? (Yes or No) Yes 
Boot file to update (default FEP0:>Boot.boot) : RETURN 

Now you should test the world you just built. Since you are about to throw away 
the distribution world by making it be the replacement extra paging file you 
should make sure the world you are trusting to be all right really is. To do this 
cold boot the machine again. ' 

Command: Logout 
Command: Halt Machine 

Lisp stopped itself. 

FEP Command: Load World (default: FEP0:>Genera-7-0-dist.load) 

>Genera- 7-0-Acme.load 
FEP Command: Start 
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Note that you don't have to clear the machine, reload the microcode, or set the 
chaos address again. Try out a couple of things in the world. The Lisp Listener 
should come up clean, the editor should not have anything in it, and so forth. 
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Final Details Of Step 6 

Finally, you should now update Bootboot to use the auxiliary paging file having 
first made sure that there is one. We use the old distribution world as the new 
paging file. If your machine arrived with the distribution world already on the 
disk, you should write the distribution world to tape prior to deleting it from the 
disk. 

Command: Rename File (existing name [default ...]) Genera-7-O-dist.load 
(new name) FEPO:>pagel.page 

Command: Edit File (file [Default: ...]) fepO:>boot.boot 
Insert the following line just before the Load Microcode command: 

Declare Paging fep0:>page pagel 
Now, halt the machine and reboot to make sure it works: 

Command : Logout 

Command : Halt Machine 

Lisp stopped itself. 
FEP Command: Boot 
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9.13 Step 7 - Copy the non-server world to the other non-server 
machines. 

In order to copy a world load file from one machine to another, both machines 
must be running and configured for the local site. Thus, you must boot the third 
machine by hand and configure it for the local site. 

FEP Command: Clear Machine 

FEP Command: Load Microcode(default:>tmc5-io4-st506-mic.mic.336)364O-mic.mic 
FEP Command: Load World (default: >World1 .load) >Genera-7-0-dist.load 
FEP Command : Set Chaos-address 403 
FEP Command: Start 



Command: Set Site (site name) acme 

Define a new site named ACME (as opposed to looking for an existing 

definition of ACME on disk)? (Yes or No) No 
What host is a namespace server for ACME (default: Local): lispm-1 
Chaosnet address for lispm-1: 401 
Host responds as LISPM-1, ok? (Y or N) Y 
The local host is now LISPM-3. 

Now, copy the world to the local machine, first making room by deleting aux.page. 
Command: Delete File FEP0:>aux.page 
Command. Expunge Directory FEP0:> 

FEP8 :>*.*.*: 35888 blocks freed. 

Command: Copy World (from FEP file [default FEP8:>foo.load]) 
lispm-l|fepO:>Genera-7-0-Acme.load (to [default 
FEPB : >Genera-7-8-Acme . 1 oad] ) RETURN 

Copying from LISPM-1 to local host; 

Remote band is 
FEP0:>Genera-7-0-Acme.load.1 35887 41341824 (8) 11/09/86 08:15:32 [Genera 7.0] LISPM 

Using the fast blast protocol. 

Do you really want to receive 35887 remote file blocks to local? (Yes or No) Yes 
100 . . . 
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Do you want to update the boot file to load FEP0:>Genera-7-8-Ac m e.load.1? (Yes or No) 
Yes ' 

Boot file to update (default FEP0:>Boot.boot) : RETURN 
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Now, you should test the world you just copied. Since you are about to throw 
away the distribution world by making it be the replacement pagel.page file, you 
should make sure the new world is trustworthy. To do this, cold boot the machine 
again. 

Command : Logout 
Command: Halt Machine 

Lisp stopped itself. 

FEP Command: Load World (default: FEP0:>Genera-7-0-dist.load) 

>Genera-7-0-Acme.load 
FEP Command: Start 

Again, you don't have to clear the machine, load the microcode, etc. Poke around 
make sure the world seems intact. 

Finally, it's time to rename the old distribution world and bring the boot file into 
its final form. 

Command: Rename File (existing name [default ...]) Genera-7-O-dist.load 

(new name) FEPO:>pagel.page 
Command: Edit File (file [Default: ...]) fepO:>boot.boot 

Insert the following lines after the Load World command and before the Start 
command: 

Declare Paging fep8:>page pagel 
Don't forget to update the Chaos address if you haven't already done so. 
Now, shut down the machine and reboot to make sure it works: 

Command: Logout 

Command : Halt Machine 

Lisp stopped itself. 
FEP Command: Boot 

That's it! 



. 103 

November 1986 " ' " — 

Site Maintenance 



9.14 Site Configuration Lab 

In this lab you will work with a partner. Your goal is to follow the outline 
presented below and together create a site of two lisp machines. 
Things to remember: 

1. You are on a network with other students. 

2. Specify your chaos addresses, site name and machine names carefully. 

3. Work together. Make sure you are both involved and tuned in. 

4. If there is already a LMFS on your namespace server use it. 

5. You will need a FSPT.FSPT file on the drive you are booting from if it is 
not the drive your LMFS is on. 

6. If you are stuck...ask for help 

7. If you suspect a problem.... stop... and ask for help 



Lab Partner: 



Site Name: 



Name of Lisp machine 1: . Cnaos Address 

Name of Lisp machine 2: . Chaos Address 

Follow these steps: 
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1. Boot the distribution world by hand on machine 1. 

2. Login as the sys host 

3. Build a LMFS (1000 blocks) 

4. Set the site 

5. Add other host to namespace 

6. Add a user to the namespace 

7. Boot the machine again to clear all the garbage 

8. Set site, answering no to "Define new site?" 

9. Save the world to disk 

10. Edit the boot file FEP0:>boot.boot to boot your new world 

11. Reboot using your new boot file 

12. Now, on machine 2 boot the distribution world 

13. Set the site 

14. Save the world to disk 

15. Edit the boot file FEPO:>boot.boot to boot your new world 

16. Reboot using your new boot file 

17. Done 
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10. Installing Layered Software 



Distribution Tapes 
Systems 

Logical Pathnames 
Patches 
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10.1 Introduction 

This chapter discusses the concepts and procedures involved with installing layered 
software. Layered software is software which is not part of the Genera 
environment (which comes with each machine). Layered software can come from 

™ ™ me PaSCa1, F ° rtran ' IP/TCP ' Color ' etc) > from outside developers (like 
ART, KEE, and ICAD), or from your own site. 

The software installation process consists of two required steps and an optional 

step: r 

1. Restoring software from a tape to a file system. 

2. Loading the software from the file system into the Lisp World. 

3. Saving a world with the software loaded. (Optional) 

There are two software facilities which make this process easier for both the 
programmer and the system administrator: Logical Pathnames and Systems This 
chapter will help you understand the concepts behind and use of these software 
tools. 



10.2 Concepts 

10.2.1 Systems 

A system organizes a group of related files into a single unit. We can perform 
operations, such as loading into memory, storing on tape, or reloading from tape 
on all of the files at once by referring to them by their system name. " ' 

10.2.2 Logical Pathnames 

Logical Pathnames allow programmers to create site independent software. 

Logical pathnames have the same components as physical pathnames, but different 
syntax: 

Host Directory Name Extension Version 

logical -host: log-dir; test . lisp 3 

Programmers use logical pathnames wherever they would use physical pathnames 
The system translates any reference to a logical pathname into a physical 
pathname appropriate for the current site. As site administrator, you define the 
translations for your site. 
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Without logical pathnames, each piece of software would have to be specially 
written for a given site, or each site would have to have exactly the same hosts 
and directory structures. Neither of these requirements would be at all desirable 
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10.3 Distributing Systems 

How do systems get created and what do you do when you receive a tape 
containing one? 

10.3.1 Programmer's Steps 

Here is a simplified explanation of what the programmer does to create a system 
and ship a system. 

1. The programmer creates a program consisting of a group of files. For 
example: 

c : >roy>admi n-proj ect>i inventory . 1 i sp 

c : >roy>admi n-proj ect>parts . 1 i sp 

c : >roy>adm i n-proj ect>d i agnosti cs . 1 i sp 

2. The programmer defines these files to be a system, here, a system called 
ADMIN: 

(def system admin 

a bunch of stuff we aren't interested in) 

3. The programmer places this definition in a file, for instance: 

c:>roy>admi n-proj ect>admin-def system. lisp 

This file must be loaded every time the machine is cold booted, in order to 
define the components of the ADMIN system. 

4. Once the system is defined by evaluating this defsystem form, I can load 
the entire program by typing: 

Connand : LORD SYSTEM RDMIN 

5. Next, the programmer creates logical pathnames which correspond to the 
physical files. 

admi n-host : admi n-di r ; i nventory . 1 i sp 

admi n-host : adm i n-di r ; parts . 1 i sp 

adm i n-host : admi n-di r ; di agnosti cs . 1 i sp 

6. The programmer puts these files onto a Distribution Tape and ships the tape 
to you. 
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10.3.2 System Administrator's Steps for Installing Systems 

When you receive a distribution tape: 

1. Place the tape in a tape drive on one of you Symbolics Computers (probably 
your file server). * J 

2. Read the installation instructions, which should list all of the logical 
pathnames which the program uses. Choose the physical directories which 
you want to correspond to the program's logical pathnames. Create the 
translations between the logical and physical pathnames. 

3. Enter the form (dis: load-distribution-tape) to a Lisp Listener. This pops 
up a menu which allows you to choose which systems are to be restored 
from the tape. 

10.3.3 Specific Steps 

1. Place the tape in the tape drive. 

2. Now we will define the logical pathname and system information necessary 
to restore the system from tape and load it into our Lisp World. 

a. First we use Zmacs to create a new file called 

sys : si te ; admi n . system 

Notice that this is a logical pathname. The directory sys site- is 

7™t & l CVery ^ (ln faCt} * y0U l00k back t0 where ™ seated the 
ACME site, you will see that the system asked us about sys site- at 
the very beginning). This directory contains some site specific ' 
information, including the definitions for each system known at that 
site. In this case, we are defining the system called "Admin" so we 
create the file 

adm i n . system 

The file will have the following Lisp code in it: 

(fs: make-logical -pathname-host "admin-host") 

(si :set-system-source-file "admin" 

"admin-host: admin-dir; admin-defsystem.l isp") 

The first Lisp form declares that there is a logical host named 
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ADMIN-HOST. This second form declares that the DEFSYSTEM form, 
which defines all the ADMIN system's components, can be found in the 
file LM1 : >tool s>admi n-def system . 1 i sp. 

b. Next we create a translations file 
sys : si te ; admi n-hos t . transl ati ons 

This file will contain the translations between the logical pathnames 
used by the ADMIN system and the physical pathnames we are going 
to use at our site. The logical pathnames for which we must provide 
translations were listed in the installation guide which came with the 
software. The physical pathnames they translate to are our choosing. 
The translations file will look like this: 

(fs: set-logical -pathname-host "admin-host" 
: physical -host "LM1" 
translations ' (("admin-host:admin-dir ; " "LM1 :>tools>"))) 

This tells the system that all references to admin-host should be 
translated into references to LM1 and that all references to the 
directory admin-host: admi n-dir; should be translated to LM1:>tools>. 

c. Once we have created and saved these two files, we need to have the 
system "read" them. Go to a Lisp Listener and type 

Command: Load File sys: site; admin. system 

This loads the system file (which loads the translations file, when the 
fs:make-logical -pathname-host form is evaluated. 

d. Now that we've defined all the appropriate translations, we can load 
the software from the tape. 

Command : (di s : 1 oad-di stri buti on-tape) 

The system will ask you about the tape drive you are using. If you are 
using the cartridge tape on the same machine, simply press RETURN. 

A menu will pop up. Clicking on [DO IT] will load all of the software 
on the tape. Alternatively, if there is more than one system on the 
tape, you can choose which systems to load and which not to load. 

e. After restoring the files from the tape, type: 
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Command: Load System ADMIN 

This will load the ADMIN system into the Lisp World and make it 
available for use. 

These steps make the ADMIN system available to all users at the site They 
simply issue the command Load System admin and then start the program. 

3. Finally, if you wish to save the version of the world with the system loaded: 

a. Cold boot a machine 

b. Use Load Systen to load the software 

c. Use Save World to save the modified world. 
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10.4 Installation Lab 
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11. Garbage collection 



What is Garbage 

Collection of Garbage 

Ephemeral 

Dynamic 

Immediate 

Full 

Gc And Making World Loads 
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11.1 Garbage Collection 

As you program in Lisp, you use up large amounts of virtual memory This 
"consing", which is a byproduct of everything you do on the machine, will 
eventually cause your machine to run out of memory, at which time you'll be 
forced to cold boot. 

The GC is a facility that reclaims space which no longer contains useful 
information, and allows you to reuse it. 

11.1.1 Types of Garbage Collection 

For some modes of GC, you can work independently while the GC is going on 
others require the entire machine. These two categories of garbage collection are: 

Incremental Allows you to do other things while GC is in progress. 

Non-incremental Freezes your machine until GC has completed. 

11.2 The Garbage Collectors 

11.2.1 Ephemeral 

Command: Start GC :Ephemeral 
Command: Halt GC 

Incremental: You can work on other things while GC is going on. 
Happens in small increments from time to time. Assisted by hardware and 
firmware EGC tends to increase locality of objects and their references, meaning 
that related data tends to be concentrated on fewer pages. Greatly decrease 
Easing. In fact, compute-bound jobs run faster with EGC on due to the decreased 
paging demand. " 

11.2.2 Dynamic 

Command: Start GC : Dynamic 

Command: Halt GC 

Incremental: You can work on other things while GC is going on. 

You would turn on Dynamic to load in a program which is SO huge that the 
program won't fit into memory unless you do so. 
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11.2.3 Immediate 

Command: Start GC immediately 
Command: Halt GC 

Non-incremental: starts GC at once; you can't do anything else while it's 
happening. 

fZ^flf 6 ^ ^"t ^ foil dUe t0 lack 0f s P ace - You m ^t want to gc- 
lmmediately when you leave for the day. S 

11.2.4 Full 

(si:full-gc) 

No command to stop it. 

hl°p n p ^ing mental: 8tartS GC ^ ° nCe; y ° U Can,t d ° anything else while it>s 

Only do Full GC when you are creating a new world. Boot the vanilla world 
Load the huge system (Full GC is overkill for loading a small system aid then 
save the world. In most cases it will reduce the size of the worU 

11.3 GC And Making World Loads 

Turn on the Ephemeral Garbage Collector (EGC) right after booting a world vou 
are planning to modify and then save to disk. 7 

Do^i use the dynamic, immediate or full garbage collectors if you are going to 
create an mcrernental world. These garbage collectors modify many pages of 
memory and will make your incremental world huge. 

After you have loaded your software, running the immediate or full garbage 

create ^ "^ ^ *" °' *» COmplete W ° rld load *»«*** to 

11.4 GC And Normal Operations 

On an everyday basis the recomended use of garbage collectors is: 

• Ephemeral GC On 

• Dynamic GC Off 

• Run an Immediate GC at the end of the day. 
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The Ephemeral GC is on by default when you cold boot your machine (starting in 
Genera 7.0). 
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12. Useful Odds And Ends 



Lisp Machine Etiquette 
Classic Mistakes in Site Administration 

Useful Tricks 
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12.1 Lisp Machine Etiquette 

Save your work 

If you've been editing any files, save out any changes to disk. Same for any mail 
you ve been reading. Same for any program you've been using. Make sure 
everything you want to keep is saved in a file, not just a buffer. 

Logout 

Logging out does two things: (1) it sniffs around to see if there's anything that it 
knows about which is changed but not saved in a file (and questions you about it) 
and (2) removes your name from the bottom of the screen so others will know that 
the machine is free. 

Logging out does not get rid of any editor buffers. 

Boot 

Ji S %™ C ™ mand H u U " achine to St ° P the Lis P P ro ^ssor and return control to 
the FEP Then at the "Fep Command:" prompt, type Boot. This will cold boot 
your machine. The next person then knows that the machine is free to use 
because it will say "cold-booted" at the bottom. If anything is done to the ' 
machine after being cold booted, that message goes away. 

Booting gets rid of all editor buffers. 
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12.2 Classic Mistakes in Site Administration 

Deleting the worl d you are running 

Undelete it if you haven't expunged the directory. You are now OK. 

If you have another world on disk that you can boot from you are OK Halt the 
machine and boot that world. 

If you have not created any new files in the FEP directory since the expunge you 
can try running the function <si:copy-world-out-of-load-map). This will move the 
all the pages of your world into your paging area. Go on to next paragraph for 
more instructions. 

If you don't have a world to boot from you should attempt to create a FEP file big 
enough (35000 blocks) to hold a world. If that works, you can either try restoring 
a world from tape using the FEP command Disk Restore or doing a COPY world 
command to bring a world from another machine. You may want to call your 
software support person or HOSS before you try this. 
Deleting all paging fil Pg 

Less severe because you could use another FEP file (eg. a world load) as paging 
space. If there is nothing on disk that is suitable to page on try the command 
Create FEP File. 

Deleting vour >B AD- BLOCKS FF.P fiU 

All of a sudden, all the bad blocks will be availble for use by the FEP file system 
Don't delete any of the other ".FEP" files, either. 7 

Deleting a non-empt y LMFS nartitirm 

If you want to reduce the size of LMFS use the FSEdit menu option Remove 
Partition. If you do delete and expunge a non-empty LMFS, you have destroyed 
your file system. Go get the backup tapes. 

Deleting vour F8PT FSPT filp 

If you have a multi partition LMFS and you delete this file, the next time you 
boot the machine will not be able to find half of the file structure To fix this 
just create the file in ZMACS. 
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12.3 Useful Tricks 

When the machine is "stuck": Cold-booting is a last resort. Warm-booting is 
better than cold-booting because you don't lose the state of the Lisp World. The 
start command in the FEP warm boots. 

c-h-Function will get you to the FEP so you can warm or cold boot. 

The function (zwei : save-all -files) will save all your editor buffers. 

Function c-Cl ear-Input clears out many window system problems. ["It's stuck."] 

Use Select P (for Peek) to examine various things about the running system. 
Useful for bashing things with a large hammer. Requires that you be creative 
- there isn't a particular single right thing to do with this program. Resetting 
processes is a common but severe thing to do. 

When there's a software bug that you want to report, use the c-M command in the 
debugger to show the context of the error. 

Use the document examiner. It can help you find things quickly when you have 
no idea where in the documentation set to look. 

If you run out of swap space, you can do Add Paging in the FEP, and then Start 
in order to keep going. However, this requires that there be a file already 
available to add for paging. In an emergency you can use >Reserve.FEP. 

You can distribute the source files of the Lisp Machine system and any layered 
software across as many hosts as seems prudent, by making the logical host 
translate to the right places. This gives you the capacity to spread files across 
the various hosts, if you've got lots of one drive 3640's. 

If you have a dedicated Lisp Machine as a file server, look at the file 
SYS:EXAMPLES;FILE-SERVER-INIT-FILE.TEXT for some ideas as to what 
software customizations the dedicated Lisp Machine file servers at Symbolics have. 

You can login at any site by using the form (si :login-to-sys-host). This logs 
you in as an innocuous user. The name of the user varies from site to site, but 
the function always works. "LISPM" is a common name. 

If you click on Local in the namespace object menu, updates will affect only that 
machine. If you modify the namespace locally on the namespace server, then all 
machines at the site will see the change. However, the local change is not 
written into the namespace database on disk, and will go away when you boot the 
server. 
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